home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / dev / gui / select_gc.readme < prev   
Encoding:
Text File  |  1999-09-06  |  4.8 KB  |  118 lines
  1. Short:    BOOPSI pop-up, cycle and button gadget
  2. Author:   tanti@intercom.it (Massimo Tantignone)
  3. Uploader: tanti@intercom.it (Massimo Tantignone)
  4. Version:  40.15
  5. Type:     dev/gui
  6. Requires: AmigaOS 3.0+
  7.  
  8. select.gadget 40.15 (19.6.99) by Massimo Tantignone
  9.  
  10. The select.gadget is a shared library which, when opened, adds to the system
  11. a public BOOPSI gadget class called "selectgclass". This class implements a
  12. button-like selection gadget, with features similar to those of a traditional
  13. GadTools cycle gadget, but with the additional ability to open, when pressed,
  14. a pop-up menu which allows the user to pick his choice more easily.
  15.  
  16. The look and behavior of the gadget and its pop-up menu can be configured
  17. using the attribute tags of the class.
  18.  
  19. The library is freeware; if you use it, you are allowed to distribute it
  20. with your software.
  21.  
  22. Some highlights:
  23.  
  24. - A delay can be set for the appearance of the pop-up menu, allowing for a
  25.   gadget which reacts like a normal cycle gadget upon "quick" clicks, and
  26.   like a pop-up gadget if the mouse button is kept pressed a little longer.
  27.  
  28. - The pop-up menu can appear and disappear with a vertical "zoom" effect
  29.   whose duration is configurable.
  30.  
  31. - It is optionally possible to have a "sticky" pop-up menu which remains
  32.   open when the mouse button is released.
  33.  
  34. - The gadget can be made "quiet", that is, the currently selected item can be
  35.   not displayed. Useful to attach a small pop-up button to string gadgets.
  36.  
  37. - The gadget can be configured to always behave like a cycle gadget, and
  38.   even like a plain button gadget.
  39.  
  40. - The gadget can broadcast changes in its value to target objects via the
  41.   BOOPSI notification system.
  42.  
  43. - All changes done with SetGadgetAttrsA() to the gadget's position, size
  44.   and look are visually executed in real-time.
  45.  
  46. - The gadget's dispatcher is able to swap the stack when needed.
  47.  
  48. - The gadget can be added to requesters and window borders.
  49.  
  50. - The pop-up menu can have a drop shadow.
  51.  
  52. - The gadget's "pop-up" symbol can be placed at the left side, at the right
  53.   side, or it can also not appear at all; its width is also configurable.
  54.   The gadget's default imagery for the symbol is fully scalable, and it can
  55.   be replaced by the application with a custom image.
  56.  
  57. - The default values for unspecified attributes can be globally set by the
  58.   user with an ASCII preferences file; the changes are applied in real-time
  59.   (to gadgets created afterwards) via file notification.
  60.  
  61. Furthermore, the library offers some functions which allow to "transform"
  62. a normal gadget into a custom gadget having (almost) the same features of
  63. the "selectgclass" gadgets.
  64.  
  65. This way it's possible, for example, to create GadTools GENERIC_KIND gadgets
  66. and turn them into pop-up gadgets, obtaining all the benefits of this type
  67. of gadgets while also keeping the benefits of the GadTools automatic gadget
  68. creation (and deletion) system.
  69.  
  70. Lastly, this gadget class supports VisualPrefs and takes full advantage of
  71. the graphic enhancements it brings to the system.
  72.  
  73. Changes since version 40.14:
  74.  
  75. ยท Now the gadget preserves the pen color of any IntuiText passed to it
  76.   rather than incorrectly changing it to TEXTPEN.
  77.  
  78. Author:
  79.  
  80. Massimo Tantignone
  81. Via Campagnoli, 4
  82. 28100 Novara (NO)
  83. ITALY
  84.  
  85. E-mail: tanti@intercom.it
  86.  
  87.  
  88. ============================= Archive contents =============================
  89.  
  90. Original  Packed Ratio    Date     Time    Name
  91. -------- ------- ----- --------- --------  -------------
  92.    22872   13611 40.4% 20-Jun-99 00:23:46 +select.gadget
  93.      255     155 39.2% 16-Jan-99 01:26:32 +select.prefs
  94.      715     287 59.8% 12-May-98 10:30:34 +selectgadget_protos.h
  95.     2184     691 68.3% 16-Jan-99 01:41:42 +select.h
  96.      462     177 61.6% 12-May-98 10:56:52 +selectgadget_pragmas.h
  97.      210     139 33.8% 12-May-98 10:58:54 +selectgadget.h
  98.     4810    1425 70.3% 26-May-98 20:21:46 +Install
  99.      681     344 49.4% 26-May-98 23:17:14 +Install.info
  100.     2479    1012 59.1% 16-Jan-99 02:01:18 +ReadMe.user
  101.      464     213 54.0% 26-May-98 12:24:12 +ReadMe.user.info
  102.    44587   13428 69.8% 21-Jul-99 11:32:50 +select.doc
  103.      464     212 54.3% 16-May-98 15:47:34 +select.doc.info
  104.    47742   14059 70.5% 21-Jul-99 11:32:10 +select.guide
  105.      468     226 51.7% 26-May-98 23:17:14 +select.guide.info
  106.      324     207 36.1% 12-May-98 10:28:34 +selectgadget_cl.fd
  107.     9504    5940 37.5% 30-Jan-99 02:10:26 +SelGadgTest
  108.     9399    2262 75.9% 30-Jan-99 02:07:32 +SelGadgTest.c
  109.      464     227 51.0% 26-May-98 23:17:14 +SelGadgTest.c.info
  110.      454     188 58.5% 26-May-98 23:17:46 +SelGadgTest.info
  111.     9404    6007 36.1% 27-May-98 20:28:58 +SGCustomTest
  112.     7239    2176 69.9% 27-May-98 20:26:26 +SGCustomTest.c
  113.      464     223 51.9% 26-May-98 23:17:14 +SGCustomTest.c.info
  114.      454     191 57.9% 26-May-98 23:17:14 +SGCustomTest.info
  115.     1220     412 66.2% 21-Jul-99 11:22:52  select_gc.info
  116. -------- ------- ----- --------- --------
  117.   167319   63812 61.8% 22-Jul-99 03:12:48   24 files
  118.